home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / hard / drivr / IOBlix12Usr377.lha / Goodies / SerMouse / SerMouse.doc < prev    next >
Text File  |  1998-10-30  |  10KB  |  272 lines
  1. $VER: SerMouse 2.21, serial mouse package (+driver) for PC mice.
  2.  
  3.  
  4. Welcome to:
  5.  
  6.  
  7.  
  8.                      \                |              /
  9.  
  10.                    -   The ultimate PC-Mouse package   -
  11.  
  12.                      /                |              \
  13.  
  14.  
  15.  
  16. A lot of people don't like the standard Amiga mouse (and I don't blame 'm).
  17. And if they do like him (I like to 'personalize' my mouse) he (she?) dies
  18. within a short period of time. The market for specific Amiga mice is very
  19. small. Most people like the PC mice and trackballs. I 'm using a PC mouse
  20. of Q-tec, after my Amiga mouse died some years ago. To make it a bit easier
  21. for people to use PC mice and trackballs on the Amiga, I decided to write
  22. this packadge for the use of PC-mice on the Amiga. This package and the
  23. included software is free-ware. You may use it and copy it freely, but you
  24. may not modify it in any way! I'm not responsible for any damage that may
  25. occuur while using the software or using the descriptions in here to modify
  26. hardware, or anything else that might be caused by the existance of this
  27. package. Also, I don't guaranty any mouse or trackball to work with this
  28. package. There are still mice and trackballs with other protocols or
  29. hardware-connections.
  30. This package contains the following things (in this doc or the archive):
  31.  
  32.  * A serial mouse driver for both Microsoft mice and Mouse System mice.
  33.  
  34.  * A description for converting 9-pin Sub-D serial to 25-pin serial.
  35.  
  36.  * A description for converting 9-pin Sub-D BUS-mouse to 9-pin Amiga
  37.    mouse.
  38.  
  39.  * A description for converting 9-pin Mini-Din BUS-mouse to 9-pin Amiga
  40.    mouse.
  41.  
  42.  
  43.  
  44. The SerialMouse-driver
  45. ----------------------
  46.  
  47. The SerialMouse-driver is called "SerMouse" and should be included in this
  48. package. It can only be used with Kickstart version 2.0 or above. The
  49. current version is 2.21. You can start it from the command-line by typing
  50. "SerMouse" or from the WorkBench by double-clicking on it's icon. To
  51. deactivate it, just restart the program. If you want to activate it every
  52. time your computer is switched on, add the command in your s:user-startup
  53. or drag the icon to the WBStartup drawer (do not remove the DONOTWAIT
  54. tooltype!).
  55.  
  56. You can specify the following things either as command-line argument or as
  57. icon tooltype:
  58.  
  59.  
  60. 3BYTES or 5BYTES
  61.  
  62. This indicates the mouse-type you're using. 5BYTES is the default and most
  63. used type. If you've got a 3-button mouse, it's deffenetely a 5BYTES type.
  64. If the mouse doesn't work, just try the other type... I named the types
  65. by the number of bytes they sent for one event.
  66.  
  67.  
  68. DEVICE
  69.  
  70. The device to be used for reading serial data. Default is the
  71. serial.device. SerMouse has been tested with the VECTOR Connection multi
  72. I/O card and it worked without any problems.
  73.  
  74.  
  75. UNIT
  76.  
  77. The device-unit to be used for reading serial data. Default is unit 0.
  78. Also tested with the VECTOR board.
  79.  
  80.  
  81. PRIORITY
  82.  
  83. This is the task-priority of the mouse-driver. The default is 20. This
  84. should be OK. It's the same priority as the input.device eg. the standard
  85. mouse.
  86.  
  87.  
  88. HARDBUTTON
  89.  
  90. There are still a very few programs which hit the hardware directly in
  91. order to get the state of the mouse-buttons (Protracker is one of them).
  92. SerMouse interacts with the OS only. The mentioned bad programmed programs
  93. won't notice the button-press, because they don't use the OS (for that).
  94. When you specify the option HARDBUTTON, SerMouse will use a 'reversed'
  95. hardware-hit to 'emulate' the Left mouse-button. This is very bad
  96. programming, but there is no alternative! Use this option only if strictly
  97. necsecairy! Avoid pressing buttons on devices atached to game-port 0 when
  98. this option is active! I'm not responsible for any damage!
  99.  
  100.  
  101. The program SerMouse is (c) by me (K.P. van Beem) and is distributed as
  102. FreeWare. This means, you may freely use and distribute it, as long as the
  103. programm and this documentation is left unchanged. The source of the
  104. programm is available as GiftWare. Contact me if you're interested in it.
  105. It's partly C and partly assembler.
  106.  
  107. Be sure pin 22 of the serial-port is NOT connected to any line of the
  108. mouse when you use a serial mouse. This will interfere with your parallel
  109. port.
  110.  
  111.  
  112.  
  113. Converting 9-pin Sub-D serial to 25-pin serial
  114. ----------------------------------------------
  115.  
  116. Most serial mice do have a 9-pin Sub-D serial connector (that's the two-row
  117. connector, NOT a din!). The Amiga has a 25-pin serial connector. In most
  118. stores, you can by adapters from 9 to 25 pins. For those who want to build
  119. them in stead of by them, or just want to connect a 25-pin connector
  120. directly to the wire, this is how you should connect it (the pin-numbers
  121. are normally written on the connectors):
  122.  
  123.  
  124.   9-pin           25-pin
  125.   D-Sub           D-Sub
  126.  
  127.     1       <==>     8          Carrier Detect
  128.     2       <==>     3          Recieve
  129.     3       <==>     2          Transmit
  130.     4       <==>    20          Data Terminal Ready
  131.     5       <==>     7          Signal Ground
  132.     6       <==>     6          Data Set Ready
  133.     7       <==>     4          Request To Send
  134.     8       <==>     5          Clear To Send
  135.  
  136. Do NOT connect pin 22 on the Amiga side (with pin 9 on the mouse side).
  137. This will interfere with the parallel port of your Amiga. This line is the
  138. Ring Indicator which is only used by modems (and most of the time not by
  139. Amiga software).
  140.  
  141. And don't forget the shield-ground.
  142.  
  143.  
  144.  
  145. Converting 9-pin Sub-D BUS-mouse to 9-pin Amiga mouse
  146. -----------------------------------------------------
  147.  
  148. Besides serial mice, there's an other type of mouse that is used for the
  149. PC. Although not often these days. It's called the BUS-mouse. It's basicly
  150. the same mouse as the Amiga (and the Atari) is using, but differently
  151. wired. You can easily rewire the mouse (or make an adapter) and connect the
  152. mouse on the mouse-port of the Amiga, just like you do with your standard
  153. Amiga mouse. This way, you can use this type of mouse without a separate
  154. driver. This is the way I use my PC mouse on the Amiga. You should rewire
  155. the mouse as described below:
  156.  
  157.      Amiga side            Mouse side
  158.        D-Sub                  D-Sub
  159.  
  160.      5 4 3 2 1             5 4 3 2 1
  161.       9 8 7 6               9 8 7 6
  162.  
  163.         1         <==>          4       Vertical pulse
  164.         2         <==>          1       Horizontal pulse
  165.         3         <==>          3       Vertical pulse Qualifier
  166.         4         <==>          2       Horizontal pulse Qualifier
  167.         5         <==>          5       Midle button
  168.         6         <==>          6       Left button
  169.         7         <==>          7       +5V
  170.         8         <==>          8       Ground
  171.         9         <==>          9       Right button
  172.  
  173.  
  174.  
  175. Converting 9-pin Mini-Din BUS-mouse to 9-pin Amiga mouse
  176. --------------------------------------------------------
  177.  
  178. For a description of the BUS mouse, see above. Besides the Sub-D plug, most
  179. modern computers do have a mini-Din to connect the bus-mouse to the
  180. computer. Of cause, these can also be rewired. Belose is described how. I
  181. haven't tested this, but I took it from a German magazin.
  182.  
  183.     Mouse          Amiga
  184.    Mini-DIN        D-SUB
  185.  
  186.       1     <==>     7      +5V
  187.       2     <==>     2      Horizontal pulse
  188.       3     <==>     4      Horizontal pulse Qualifier
  189.       4     <==>     1      Vertical pulse
  190.       5     <==>     3      Vertical pulse Qualifier
  191.       6     <==>     6      Left button
  192.       7     <==>     5      Middle button
  193.       8     <==>     9      Right button
  194.       9     <==>     8      GND
  195.  
  196. I'm not sure the pin-nubers are written on the Mini-Din, besides, if you
  197. don't make an adapter but just rewire it, you won't have the bus. So I'l
  198. give the numbers here. You are looking at the soldier side of the bus, so
  199. at the pin-side of the plug!
  200.  
  201.                   |__|
  202.  
  203.                 7   8  9
  204.                3  4  5  6
  205.               __ 1   2  __
  206.                 |      |
  207.  
  208.  
  209.  
  210. Changes since 2.00 (so new for 2.20)
  211. ------------------
  212.  
  213. * Added the warning in the docs about pin 22 (ring indicator). This pin
  214.   should NOT be connected. With some mice, it interacts with the printer
  215.   in such a way that you won't be able to print while the mouse in
  216.   connected.
  217. * Some mouse-actions involving clicking with the mouse-buttons didn't work
  218.   as they should. This included console-clipping, drag-selecting in some
  219.   programs, double-click and other combinations in YAK and using PowerSnap.
  220.   This was partly coused by the input.device. It doesn't update the current
  221.   state of the buttons the way I tell it to do. In order to work around
  222.   this, I had to use some undocumented 'features' of the input.device. But
  223.   don't fear. It's proven to work safe on all OS versions released up till
  224.   now. Now the serialmouse-driver realy works as the 'normal' mouse!
  225.  
  226.  
  227. Changes since 2.20 (so new for 2.21)
  228. ------------------
  229.  
  230. * Changed the 5BYTES routine in order to get smoother mouse-movements
  231.   while using 3-button (5BYTES) mice.
  232. * Added the option HARDBUTTON, to emulate the left mousebutton for programs
  233.   which use direct hardware-hits. Use this option only if strictly
  234.   necsecairy! Also, see the explanation above under HARDBUTTON.
  235.  
  236.  
  237. Credits
  238. -------
  239.  
  240. I want to thank the following people (in alphabetical order) who helped me
  241. with this mice stuff:
  242.  
  243. Marcel Duyn, who lent me a serial mouse for testing the driver (correction
  244. as for version 2.20: I now bought it :-)) )
  245. Carsten Gerlach for finding out the couse of the serialmouse driver not
  246. working with commodities like Yak and PowerSnap. (Myself for finding the
  247. optimum solution :-)) )
  248. Stefan Johannesdal, who tested the 5BYTES part of the driver.
  249. Patrick Smith for letting me know some serial-mice do have pin 22 connected.
  250. Christian Stieber, who provided me with some technical info about the
  251. 5BYTES serial mouse protocol.
  252.  
  253. For questions, suggestions or bug-reports, you can always reach me at the
  254. adresses below.
  255.  
  256. Have fun! (Easy, 'cause you own an Amiga!)
  257.  
  258.  
  259.   _            _              _
  260.  /_)          /_)          __// Hobby programmer...  Fido: 2:280/464.2
  261. / atrick van /_)eem        \X/  e-mail: patrick.van.beem@aobh.xs4all.nl
  262.  
  263. Postal address: Parlevinker 5
  264.                 2152 LC  Nieuw-Vennep
  265.                 The Netherlands
  266.  
  267.  
  268.  
  269. Nice detail: The latest version of the Microsof mouse driver for windows I
  270. installed on my PC consumed 1.6MB of harddisk space! I think I'll stick to
  271. my Amiga :-))
  272.